package com.yesep.learn.design.behavioral.command;

/**
 * 命令模式（Command Pattern）是一种行为型设计模式，也被称为动作模式或事务模式。
 * 它的核心思想是将一个请求封装成一个对象，从而使你可以用不同的请求对客户进行参数化，并支持对请求的排队、记录以及撤销和重做等操作。以下是命令模式的详细解析：
 * <p>
 * 一、命令模式的定义
 * 命令模式将一个请求封装为一个对象，从而使你可用不同的请求对客户进行参数化；对请求排队或记录请求日志，以及支持可撤销的操作。
 * 命令模式是一种对象行为型模式，它通过将请求封装成对象，从而使得你可以用不同的请求、队列、日志来参数化其他对象。命令模式也支持可撤销的操作。
 * <p>
 * 二、命令模式的结构
 * 命令模式包含以下主要角色：
 * <p>
 * Command（抽象命令类）：声明了执行操作的接口，持有一个接收者对象，可以拥有一个或多个执行操作的方法（如execute()），由一个或多个具体命令类实现此接口。
 * ConcreteCommand（具体命令类）：实现了抽象命令接口，是接收者动作的真正执行者。它持有一个接收者对象的引用，并通过调用接收者的功能来完成命令要执行的操作。
 * Receiver（接收者）：知道如何实施与执行一个请求相关的操作，任何类都可能成为一个接收者，只要它能够实现命令要求实现的相应功能。
 * Invoker（调用者）：负责调用命令对象执行请求，它不直接访问接收者，而是通过命令对象来间接调用接收者。调用者持有一个或多个命令对象的引用。
 * Client（客户端）：创建具体命令对象并设置其接收者，然后将命令对象传递给调用者。客户端并不直接调用命令的execute()方法，而是通过调用者的某个方法来间接引起命令的execute()方法被调用。
 * 三、命令模式的优点
 * 降低对象之间的耦合度：命令模式使得调用者与接收者之间不存在直接引用，降低了它们之间的耦合度。
 * 新的命令可以很容易地加入到系统中：只需实现一个新的具体命令类即可扩展系统的功能，无需修改现有类的代码。
 * 可以比较容易地设计一个组合命令：通过组合多个命令来完成复杂的请求，使得系统更加灵活。
 * 支持撤销和重做操作：由于命令对象可以记录请求的历史信息，因此可以很容易地实现撤销和重做功能。
 * 支持事务处理：可以将多个命令组成一个事务，在事务中的命令要么全部执行成功，要么全部不执行，从而保证数据的一致性。
 * 四、命令模式的缺点
 * 类的数量增加：使用命令模式可能会增加一些新的类和对象，从而增加了代码的复杂性。
 * 额外的开销：封装命令对象和操作会增加一些额外的开销，可能会稍微降低性能。
 * 可能导致过多的具体命令类：如果系统的命令比较多，可能会导致需要创建很多具体的命令类，增加了代码维护的难度。
 * 五、命令模式的应用场景
 * 需要将请求调用者和请求接收者解耦，使得调用者和接收者不直接交互。
 * 系统需要在不同的时间指定请求、将请求排队和执行请求。
 * 系统需要支持命令的撤销（Undo）操作和恢复（Redo）操作。
 * 系统需要将一组操作组合在一起，即支持宏命令。
 * 例如，在图形界面中，可以将用户点击按钮等动作封装成命令对象，并通过命令模式来实现对这些动作的处理。
 * 又如，在数据库管理系统中，可以将SQL语句封装成命令对象，并通过命令模式来执行这些SQL语句。
 */
public class Main {
    public static void main(String[] args) {
        IDevice light = new Light();
        IDevice airConditioner = new Fan(20);

        ICommand lightOn = new LightOnCommand(light);
        ICommand lightOff = new LightOffCommand(light);
        ICommand fanOn = new FanOnCommand(airConditioner);
        ICommand fanOff = new FanOffCommand(airConditioner);

        RemoteInvoker remote = new RemoteInvoker();

        // 打开灯光
        remote.setCommand(lightOn);
        remote.execute(); // Light is on.

        // 关闭灯光
        remote.setCommand(lightOff);
        remote.execute(); // Light is off.

        // 打开空调
        remote.setCommand(fanOn);
        remote.execute(); // Fan is on at 25°C.

        // 关闭空调
        remote.setCommand(fanOff);
        remote.execute(); // Fan is off.

        // 撤销最后一个操作（重新打开空调）
        remote.undo(); // Fan is on at 20°C.
    }
}
